Desktop Tools

Contents

Introduction

About this manual

Conventions used

Part 1 - Getting started

Installing Acorn C/C++

Hardware requirement

The Install application

Running the Installer application

Environment variables and Acorn C/C++

Working with desktop tools

Desktop tools

Working styles

Where to go from here

Part 2 - Interactive tools

Desktop debugging tool

Overview

About debuggers

Preparing your program

Starting a debugging session

Specifying program objects

Execution control

Program examination and modification

Options and other commands

An example debugging session

Make

Invoking Make

Using Make

Makefile format

Programmer interface

SrcEdit

Starting SrcEdit

SrcEdit menus

Printing a SrcEdit file

Laying out tables - the Tab key

Reading in text from another file

Bracket Matching

Throwback

Saving Options

The SrcEdit icon bar menu

SrcEdit task windows

Some guidelines and suggestions for using task windows

Keystroke equivalents

Part 3 - Non-interactive tools

General features

The Application menu

The Setup box

Output

AMU

Starting AMU

The Application menu

Example output

Command line interface

DecAOF

The SetUp dialogue box

The Application menu

Example output

Command line interface

Diff

The SetUp dialogue box

The Application Menu

Example output

Command line interface

Find

The SetUp dialogue box

The Application menu

Example output

Command line interface

LibFile

The SetUp dialogue box

Output

Command line interface

Link

The SetUp dialogue box

Output

Possible errors during a link stage

Libraries

Generating overlaid programs

Relocatable AIF images

Relocatable modules

Predefined linker symbols

Command line interface

ObjSize

The SetUp dialogue box

The Application menu

Example output

Command line interface

Squeeze

The SetUp dialogue box

The Application menu

Example output

Command line interface

Adding your own desktop tools

The FrontEnd module

Producing a complete Wimp application

The DDEUtils module

SrcEdit

Make

Appendices

Makefile syntax

Make and AMU

Makefile basics

Makefile structure

Advanced features

Makefiles constructed by Make

Miscellaneous features

FrontEnd protocols

Star Commands

EBNF Grammar of Description Format

WIMP Message returned after a *FrontEnd_SetUp

DDEUtils

Filename prefixing SWIs

Filename prefixing *Commands

Long command line SWIs

Throwback SWIs

Throwback WIMP messages

SrcEdit file formats

Language File Format

Help File Format

Code file formats

Terminology

Byte Sex or Endian-ness

Alignment

Undefined fields

AOF

Chunk file format

Object file format

ALF

Library file format

Object Code Libraries

AIF

Properties of AIF

The Layout of AIF

Zero-Initialisation Code

ASD

Order of Debugging Data

Endian-ness and the Encoding of Debugging Data

Representation of Data Types

Representation of Source File Positions

Debugging Data Items in Detail

ARM procedure call standard

The purpose of APCS

The ARM Procedure Call Standard

APCS variants

C Language calling conventions

Some examples

The APCS in non-user ARM modes